RoleManagerSection Class [IIS 7 and higher]
Defines configuration settings that are used to support the role management infrastructure of Web applications.
Syntax
class RoleManagerSection : ConfigurationSectionWithCollection
Methods
The following table lists the methods exposed by the RoleManagerSection class.
Name |
Description |
|---|---|
(Inherited from ConfigurationSectionWithCollection.) |
|
(Inherited from ConfigurationSectionWithCollection.) |
|
(Inherited from ConfigurationSectionWithCollection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSectionWithCollection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
Properties
The following table lists the properties exposed by the RoleManagerSection class.
Name |
Description |
|---|---|
CacheRolesInCookie |
A read/write boolean value. true if the current user's roles are cached in a cookie; otherwise, false. The default is false. |
CookieName |
A read/write string value that specifies the name of the cookie that is used to cache role names. The default is ".ASPXROLES". |
CookiePath |
A read/write string value that specifies the virtual path of the cookie that is used to cache role names. The default is "/". |
CookieProtection |
A read/write sint32 enumeration that specifies the cookie protection scheme. The possible values are listed later in the Remarks section. |
CookieRequireSSL |
A read/write boolean value. true if the cookie that is used to cache role names requires a Secure Sockets Layer (SSL) connection in order to be returned to the server; otherwise, false. The default is false. |
CookieSlidingExpiration |
A read/write boolean value. true if the cookie that is used to cache role names will be reset periodically; otherwise, false. The default is true. |
CookieTimeout |
A read/write datetime value that specifies the amount of time, in minutes, before the cookie that is used to cache role names expires. The default is 30 minutes. |
CreatePersistentCookie |
A read/write boolean value. true if role names are made cookie-persistent across browser sessions; otherwise, false. The default is false. The CreatePersistentCookie property indicates whether the cookie that is used to cache role names should be a persistent cookie, which means that the cookie is available across browser sessions, or a session-based cookie, which means that the cookie is lost when the browser is closed. The default is false, which indicates that a session-based cookie is used to cache role names. |
DefaultProvider |
A read/write string value that specifies the name of the default provider that is used to manage roles. The default is "AspNetSqlRoleProvider". This property must match a named value specified in the Providers property. An empty string ("") is not a valid value. |
Domain |
A read/write string value that specifies the name of the domain that is associated with the cookie that is used to cache role names. The default is an empty string (""). If no value is specified, the Domain property returns null. |
Enabled |
A read/write boolean value. true if the ASP.NET role management feature is enabled (that is, it can be accessed at run time); otherwise, false. The default is false. |
Location |
(Inherited from ConfigurationSection.) A key property. |
MaxCachedResults |
A read/write sint32 value that specifies the maximum number of roles that ASP.NET caches in the role cookie. The default is 25. |
Path |
(Inherited from ConfigurationSection.) A key property. |
Providers |
A ProvidersSettings value that specifies role management providers. .gif "Note") Note:
Role management providers are components that provide access to the types of roles for a site.
|
SectionInformation |
(Inherited from ConfigurationSection.) |
Subclasses
This class contains no subclasses.
Remarks
The following table lists the possible values for the CookieProtection property. The default is 3 (All).
Value |
Keyword |
Description |
|---|---|---|
0 |
None |
Specifies that the cookie information is not protected. Information in the cookie is stored in clear text and is not validated when the information is sent back to the server. |
1 |
Validation |
Ensures that the information in the cookie has not been changed before the information is sent back to the server. |
2 |
Encryption |
Encrypts the information in the cookie. |
3 |
All |
Specifies that both the Validation and Encryption values are used to protect the information in the cookie. |
Inheritance Hierarchy
ConfigurationSectionWithCollection
RoleManagerSection
Requirements
Type |
Description |
|---|---|
Client |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
ConfigurationSectionWithCollection Class [IIS 7 and higher]
NameTypeElement Class [IIS 7 and higher]
ProvidersSettings Class [IIS 7 and higher]